####################################
##Introduo a Linguagem R        ##
##Trabalho Final - Julia Dombroski##
##Funo: sof.image               ##
####################################

sof.image {seewave}								R Documentation

		Produzindo arquivo com imagem que rene 3 representaes grficas do som 					

Descrio:

Produz arquivo com imagem que possui as trs representaes grficas bsicas necessrias para a descrio 
de um som de maneira completa: espectrograma (f~t), oscilograma (a~t) e espectro de frequncia(a~f). 

Uso:

sof.image(sound, fty, winsz, flim, espcolor, fscolor)

Argumentos:

sound
	objeto R da classe "Wave".

fty

	tipo que arquivo que se deseja criar: "jpeg", "tiff" ou "png"
        
winsz
	
	tamanho de janela em pontos fft. 

flim

	limites mnimo e mximo do eixo de frequcia (kHz).

espcolor

	cor do espectrograma: se colorido argumento deve ser "colors"; para tons de cinza: "grey".

fscolor

	cor do espectro de frequncia: "rd" para espectro de frequncia em vermelho e "bl" para espectro de frequncia em preto. 	


Detalhes:

 
As representaes grficas da imagem resultante estaro organizadas da seguinte maneira: o espectrograma ocupar a maior porcentagem da imagem; empregando 
a escala do eixo de tempo (x) do espectrograma, na poro inferior da janela, ser criado um oscilograma; empregando a escalda de frequncia (y) do espectrograma, 
na poro direita da janela ser construdo um espetro de frequncia. 

Valor:

Um dispositivo grfico de imagem  ativado mas nada  retornado ao usurio. 

Aviso:
 
O objeto de entrada deve conter "f". 
A durao total do objeto ser representada graficamente. 
Para todos os tipos de arquivo o tamanho da imagem  de 16cm de altura por 16cm de largura e resuluo  de 600ppi.  
Ambos espectrograma e espectro de frequncia so calculados empregando-se sobreposio de amostras de 50% e janela "Hanning". 
O espectro de frequncia  calculado por meio da funo meanspec() 

Autore(s)

Julia R. G. Dombroski
dombroski.julia@gmail.com

Referncias:

Sueur J., T. Aubin, C. Simonis. 2007. Equipment review: seewave, a free modular tool for sound analysis and synthesis. Bioacoustics 18(2) 212-226.
 

Exemplos:
##Elaborando uma imagem em formato jpeg com espectrograma colorido e espectro de frequncia em preto.
##Tamanho de janela de 512 pontos e o eixo de frenquncia ir de 0 at 500Hz

whalecall=readWave("B.wav")
sof.image(whalecall, "jpeg", 512, c(0, 0.5), "colors", "bl")


##Elaborando, para o mesmo som de interesse (whalecall) imagem em tiff com espetrograma em escala de cinza e espectro de frequncia em vermelho.
####Tamanho de janela de 1024 pontos e o eixo de frenquncia ir de 0 at 800Hz

sof.image(whalecall, "tiff", 1024, c(0, 0.8), "grey", "rd")
 

 
